/*
 * Copyright (C) 2020 The LINN Authors
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 * in compliance with the License. You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under the License
 * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
 * or implied. See the License for the specific language governing permissions and limitations under
 * the License.
 */
package com.juqimiao.linn.interception;

import java.util.List;
import java.util.Map;

/**
 * 在应用程序生命周期中维持拦截器的信息的存储类。
 *
 * @author  Collin Cai
 */
public interface InterceptorKeeperI {

    /**
     * 获取记录前置拦截器的集合。集合按照特定拦截器接口的类型全名进行分组。
     *
     * @return 前置拦截器的集合。
     */
    Map<String, List<InterceptorI>> getPreInterceptors();

    /**
     * 获取记录后置拦截器的集合。集合按照特定拦截器接口类型全名进行分组。
     *
     * @return 后置拦截器的集合。
     */
    Map<String, List<InterceptorI>> getPostInterceptors();

    /**
     * 根据拦截器识别接口获得特定的拦截器集合。
     *
     * @param interceptorClz    用于特定组件的拦截器接口类型。
     * @param isPreInterceptor  指示是否是前置拦截器。
     * @param <T>               特定的拦截器接口类型。
     * @return                  所有实现特定拦截器接口的具体拦截器集合。
     */
    <T> List<T> getInterceptors(Class<?> interceptorClz, boolean isPreInterceptor);
}
